Skip to main content

可视化元素:趋势

象征:

_visu_icon_trend_neu.png

类别:特殊控制

该元素将变量值曲线显示为趋势图。趋势图适合表示长期数据曲线,因为数据是从趋势记录中读取的,因此也从数据库中读取。此外,您还可以运行趋势元素与日期范围选择器传奇, 和时间范围选择器操作元素,以便用户可以方便地在图表中导航。

提示

您可以在运行时通过编程删除已记录的趋势曲线。记录将从删除的时间点重新开始。

有关详细信息,请参阅:For more information, see: 编程趋势可视化

提示

趋势可视化元素无法插入到 POU 池中的可视化中。

元素属性

所有元素属性都可用吗?

只有在您选择 “” 后,所有属性才可用 高级 选项或 所有类别 过滤 特性

元素名称

例子: Velocity

提示

为元素指定单独的名称,以便更快地在元素列表中找到它们。

数据源

通过设备和应用程序连接到 趋势记录 保存要显示的趋势数据的对象。

如果 趋势记录 对象在本地设备上,那么当您指定相应的应用程序时就足够了。如果趋势记录在远程设备上,则需要指定与该设备的数据源连接。

  • _cds_icon_application.png <本地应用程序>

    趋势记录 对象位于本地应用程序中的本地设备上。

  • < device name> . < application name>

    例子: Device_A.App_A

    趋势记录 对象位于本地设备上 Device_A 在应用程序下方 App_A.

  • _visu_icon_data_sources.png < data source name >

    例子: _visu_icon_data_sources.png DataSource_B

    趋势记录 对象位于通过数据源连接的远程设备上 DataSource_B.下方(现在可见) 应用 属性,远程应用程序显示为在数据源中配置。

    例子: _cds_icon_application.png App_B

    注意:如果通过符号文件以符号方式访问数据源 CODESYS (符号),那么所需的符号文件和相应的项目必须保存在同一个文件夹中。

元素类型

趋势

趋势记录

_visu_icon_trend_recording_manager.png: 以图表形式显示数据的趋势记录

趋势记录位于指定的设备上 数据源 财产。

有关更多信息,请参阅: 趋势记录

显示设置

_visu_icon_trend_diagram.png:按钮打开 显示设置.

光标

显示光标

standard icon:趋势图中显示一个光标(带有垂直线的黑色三角形)。

运行时行为:

图形“绘制”后,用户可以沿时间轴移动光标来标记特定时间。然后属于光标位置的变量值将显示在图形上方的图例中。

_cds_img_trend_with_cursor.png

显示工具提示

要求: 显示光标 已激活。

standard icon:光标处打开工具提示。

运行时行为:属于光标位置的变量值显示为工具提示。

显示框架

standard icon:趋势图是用框画的。

数字格式

printf 语法中的格式定义,决定了值在工具提示和图例中的显示方式

例子: %d (整数变量)或 %5.2f (浮点数)

默认时间范围

可用时间范围的默认时间值

例子: 20s1m

刻度标记标签

提示

趋势记录中存储的时间是 UTC 时区。如果在可视化元素的趋势中显示时间,则时间戳将转换为 PLC 操作系统的本地时区。

如果趋势图中的时间不在您需要的时区内,请更改操作系统中的时区。

提示

您可以通过编程将系统时间的本地时区切换为世界时间 (UTC)。

当变量 VisuElems.Visu_DateTime.DisplayUTC 设置为 TRUE,系统时间显示为世界时(UTC)。默认情况下,变量 VisuElems.Visu_DateTime.DisplayUTC 设置为 FALSE 使系统时间显示为当地时区。

为了显示日期和时间值,您可以使用时区代码扩展相应的格式字符串 Z。对于本地系统时间的输出,偏移量将以世界时 (UTC) 显示。例如, dd:MM:yyyy HH:mm:ss:ms:Z 输出 01.08.2021 12:00:00:001:+02:00显示世界时间(UTC)时,也会显示UTC代码。 01.08.2021 10:00:00:001:Z

时间戳

趋势图的 X 值

  • 绝对时间戳

    时间轴上的每个刻度标记处都显示带有日期和时间的绝对时间。

    例子: 18.03.2016 12h30m50s

  • 相对时间戳

    每个刻度标记处均显示从记录开始(=0)起的时间段。

    例子: 5m30s

在两条线上绘制标注

standard icon:时间戳显示两行(例如第一行显示日期,第二行显示时间)。

_cds_icon_option_deactivated.png:时间戳显示在一行上。例如: 2019-11-01-12:30:50

忽略时间戳中的不相关信息

standard icon:时间戳以截断形式显示(不显示无关紧要的信息)。例如,第一个刻度标记处显示日期,后面的刻度标记处仅显示时间。 国际化(格式字符串) 属性不可见且被忽略。

_cds_icon_option_deactivated.png:显示时间戳和所有信息。这考虑到 国际化(格式字符串) 包含日期和时间显示格式定义的属性。

国际化(格式字符串)

时间戳的日期和时间显示的格式定义(完整显示时)

注意

仅当 忽略时间戳中的不相关信息 选择是 不是 選擇。

提示

基本上,所有 %t 支持格式选项,在 “具有格式定义的占位符” 章节。

日期

根据定义的格式返回日期显示的格式字符串。操作系统区域设置用作默认设置。

指定格式字符串的选项

  • 作为固定字符串

    例子: MM/dd/yyyy

  • 作为对文本列表条目 <文本列表名称>.<ID> 的引用

    每种语言的格式字符串都有定义。

    _visu_elem_prop_formatstring_ref_to_tlentry.png
. 定义日期的格式字符串:
  • 年: yyyyyyy

  • 月: MMM

  • 天: ddd

  • 推荐的分隔符: - . /

例子:

yyyy-MM-d 显示器 2019-10-25

yyyy-MM-dd 显示器 2019-10-25

dd.MM.yyyy 显示器 25.10.2019

dd/MM/yyyy 显示器 25/10/2019

DateTime.DTPicker

时间

根据定义的格式返回时间(或一天中的时间)显示的格式字符串。操作系统区域设置用作默认设置。

. 定义时间的格式字符串:
  • 24小时制时间定义: HHH

  • 12小时制时间定义: hhh

  • 12 小时制时间定义的 AM/PM: tt

  • 分钟: mmm

  • 秒: sss

  • 毫秒: ms

  • 微秒: us

  • 推荐的分隔符: : 或空格字符

例子:

HH:mm:ss:ms 显示器 15:30:59:123

h:mm:ss tt 显示器 3:30:59 PM

DateTime.DTPicker

位置

该位置定义可视化窗口中元素的位置和大小。这是基于笛卡尔坐标系的。原点位于窗口的左上角。正水平 X 轴向右延伸。正垂直 Y 轴向下延伸。

X

元素左上角的 X 坐标(以像素为单位)

例子: 10

Y

元素左上角的 Y 坐标(以像素为单位)

例子: 10

宽度

以像素为单位指定

例子: 150

高度

以像素为单位指定

例子: 30

提示

您还可以通过拖动框来更改值 _visu_icon_position_element.png 符号到编辑器中的其他位置。

分配的控件

这些元素是在以下情况下自动创建的: 为趋势控制插入元素 用于添加控件。

日期范围选择器

用于更改显示数据集的日期和时间的控件

_cds_icon_three_dots.png, 提供了所有实现了接口的元素 IDateRangeSelector.默认情况下, 日期范围选择器 可视化元素可用。

时间范围选择器

用于更改显示数据集时间的控件

_cds_icon_three_dots.png, 提供了所有实现了接口的元素 ITimeSelector.默认情况下, 时间范围选择器 可视化元素可用。

传奇

用于显示图表图例的控件

_cds_icon_three_dots.png, 提供了所有实现了接口的元素 ILegendDisplayer.

控制变量

12. 飞涨

缩放显示的曲线可通过鼠标或多点触控设备上的捏合手势完成。它也适用于所有轴。

在运行时 使能够TRUE,您可以按住鼠标左键,用鼠标绘制一个框。当您释放鼠标按钮时,显示会放大框,曲线也会放大。要在多点触控设备上放大或缩小,请分别将两个手指并拢或分开。

缩放和平移可以同时进行。

使能够

多变的 (BOOL) 启用或禁用缩放。

TRUE:启用缩放

例子: PLC_PRG.xZoomEnable

多变的 (BOOL

上升沿:显示因缩放而发生变化后,将显示的曲线重置为初始状态。

例子: PLC_PRG.xZoomHome

撤消

多变的 (BOOL

上升沿:显示因缩放而发生变化后,将显示的曲线重置到之前的位置。

例子: PLC_PRG.xZoomUndo

已放大

多变的 (BOOL) 表示显示的曲线是否由于缩放而发生修改。

TRUE:曲线设置已放大。

例子: PLC_PRG.xIsZoomed



13. 平底锅

平移显示的曲线是通过鼠标或多点触控设备上的捏合手势来完成的。它也适用于所有轴。

在运行时如果 使能够TRUE,然后您可以按住鼠标左键将显示的曲线拖动到另一个位置。要在多点触控设备上平移显示的曲线,请用一根手指将其拖动到另一个位置。

使能够

多变的 (BOOL)启用或禁用平移。

TRUE:启用平移

例子: PLC_PRG.xPanEnable

多变的 (BOOL

上升沿:当显示因平移而发生变化后,将显示的曲线重置到初始位置。

例子: PLC_PRG.xPanHome

被摇摄

多变的 (BOOL) 其状态指示显示的曲线是否由于缩放而被修改。

TRUE:曲线设置已平移。

例子: PLC_PRG.xIsPanned



启用 Y 轴

多变的 (BOOL)以启用 Y 轴的缩放或平移操作

TRUE:Y 轴启用。

下面描述的控制变量(日期范围开始日期范围结束)可用于以编程方式控制趋势的时间范围。这样,您就可以对趋势可视化进行编程,而无需 时间范围选择器 可视化元素。

但是,如果您希望可视化用户也能够指定时间范围,则添加时间范围选择器元素。时间范围选择器元素和 IEC 变量中的时间会自动保持同步。

注意:确保每个趋势都有自己的变量,否则趋势记录将停止。

提示:为了向用户说明趋势停止的原因, _visu_icon_trend_stopped.png 符号显示在趋势轴的末端。出现此符号时,表示当前趋势已停止,因为“缩放”或“平移”处于活动状态,或者因为时间范围被变量限制为较旧的值。

日期范围开始

IEC 变量(DATE_AND_TIMEDTLDATE_AND_TIMELDT)作为时间范围的开始时间。对于 DT 数据类型,可以达到1s的精度。

如果值发生变化,则趋势记录停止。

例子: PLC_PRG.ldtStart。仅允许一个变量(无文字)。

日期范围结束

IEC 变量(DATE_AND_TIMEDTLDATE_AND_TIMELDT) 作为时间范围的结束时间。

为了 DT 数据类型,可以达到1s的精度。

如果值发生变化,趋势记录将做出如下反应:当值增加时,趋势记录开始。当值减少时,趋势记录结束。

例子: PLC_PRG.ldtEnd。仅允许一个变量(无文字)。

中心

属性包含旋转点坐标的固定值。旋转点在编辑器中显示为 _visu_icon_center_point.png 符号并用作旋转和缩放的中心。

提示

您也可以通过拖动 _visu_icon_center_point.png 符号到编辑器中的另一个位置。

X

旋转点的 X 坐标

Y

旋转点的 Y 坐标

绝对运动

这些属性包含用于动态控制元素位置的 IEC 变量。参考点是元素的左上角。在运行时,整个元素被移动。

移动

X

  • X 位置的变量(数字数据类型)(以像素为单位)

    例子: PLC_PRG.iPos_X

在运行时增加此值会使元素向右移动。

Y

  • Y 位置的变量(数字数据类型)(以像素为单位)

    例子: PLC_PRG.iPos_Y

  • 容器变量: Container.Height

    有关详细信息,请参阅: 优化调整位置和大小

在运行时增加此值会使元素向下移动。

回转

旋转角度的变量(数字数据类型)(以度为单位)

例子: PLC_PRG.iAngle1

元素的中点在 中心 观点。该旋转点显示为 _visu_icon_center_point.png 象征。

在运行时,元素的对齐相对于可视化的坐标系保持不变。增加该值会使元素向右旋转。

_visu_img_prp_rotation.png

内部旋转

旋转角度的变量(数字数据类型)(以度为单位)

例子: PLC_PRG.iAngle2

在运行时,元素围绕指定的旋转点旋转 中心 根据变量的值。此外,元素的对齐方式会根据可视化的坐标系进行旋转。增加代码中的值会顺时针旋转。

旋转点如图所示 _visu_icon_center_point.png 象征。

注意

如果在 位置→角度 属性,然后在执行可视化时将静态旋转角度添加到可变旋转角度(偏移)。

_visu_img_prp_inner_rotation.png

提示

您可以将变量组合到 单位换算.

提示

X, , 回转, 和 内部旋转 “客户端动画”功能支持属性。

相对运动

属性包含用于移动元素的变量。参考点是元素的位置(位置 财产)。元素的形状可以改变。

左上运动

X

  • 变量(整数数据类型)的数字(以像素为单位) 剩下 边缘水平移动

    例子: PLC_PRG.iDeltaX

增加值会将元素向右移动。

Y

  • 变量(整数数据类型)为数字(以像素为单位) 最佳 边缘垂直移动

    例子: PLC_PRG.iDeltaY

增加值会使元素向下移动。

右下运动

X

  • 变量(整数数据类型)的数字(以像素为单位) 正确的 边缘水平移动。

    例子: PLC_PRG.iDeltaWidth

  • 容器变量: Container.Width

    有关详细信息,请参阅: 优化调整位置和大小

增加值会将元素向右移动。

Y

  • 变量(整数数据类型)为数字(以像素为单位) 底部 边缘垂直移动

    例子: PLC_PRG.iDeltaHeight

  • 容器变量: Container.Height

    有关详细信息,请参阅: 优化调整位置和大小

增加值会使元素向下移动。

相对运动

属性包含用于移动元素的变量。参考点是元素的位置(位置 财产)。元素的形状可以改变。

. 移动点[0]
  • X

  • Y

线的起点移动的数字(以像素为单位)的变量(数字数据类型)。

增加 X 值将元素向右移动。

增加 Y 值会使元素向下移动。

. 移动点[0]
  • X

  • Y

线的终点移动的数字(以像素为单位)的变量(数字数据类型)。

增加 X 值将元素向右移动。

增加 Y 值会使元素向下移动。

相对运动

属性包含用于移动元素的变量。参考点是元素的位置(位置 财产)。元素的形状可以改变。

左上运动

X

  • 变量(整数数据类型)的数字(以像素为单位) 剩下 边缘水平移动

    例子: PLC_PRG.iDeltaX

增加值会将元素向右移动。

Y

  • 变量(整数数据类型)为数字(以像素为单位) 最佳 边缘垂直移动

    例子: PLC_PRG.iDeltaY

增加值会使元素向下移动。

右下运动

X

  • 变量(整数数据类型)的数字(以像素为单位) 正确的 边缘水平移动。

    例子: PLC_PRG.iDeltaWidth

  • 容器变量: Container.Width

    有关详细信息,请参阅: 优化调整位置和大小

增加值会将元素向右移动。

Y

  • 变量(整数数据类型)为数字(以像素为单位) 底部 边缘垂直移动

    例子: PLC_PRG.iDeltaHeight

  • 容器变量: Container.Height

    有关详细信息,请参阅: 优化调整位置和大小

增加值会使元素向下移动。

状态变量

变量动态控制元素行为。

无形的

多变的 (BOOL) 用于切换元素的可见性

TRUE:该元素在运行时不可见。

提示

无形的 “客户端动画”功能支持属性。

动画

提示

这些属性仅在您选择了 支持客户端动画和原生元素叠加 中的选项 可视化管理器.

动画时长

元素运行动画的持续时间(以毫秒为单位)的变量

  • 变量(整数值)

    例子: Menu.tContentVAR tContent : INT := 500; END_VAR

  • 整数字面量

    例子: 500

. 动画属性
  • 绝对运动, 移动, X,

  • 绝对运动, 回转

  • 绝对运动, 内部旋转

  • 绝对运动, 外旋

当可动画属性的至少一个值发生变化时,将执行动画移动。然后执行的运动不是生涩的,而是在指定的动画持续时间内是平滑的。可视化元素在动态旋转的同时移动到指定位置。过渡很平滑。

移至前台

多变的 (BOOL) 用于在前景中设置元素

TRUE:在运行时,可视化元素显示在前台。

FALSE:在运行时,可视化元素显示在可视化编辑器中插入它的层中。

例子: bIsInForegroundVAR bIsInForeground : BOOL := FALSE; END_VAR

访问权

注意

仅当为可视化设置用户管理时可用。

访问权 按钮

打开 访问权 对话。您可以在此处编辑元素的访问权限。

. 状态消息:
  • 没有设置。完全权利。:所有用户组的访问权限: 可操作

  • 权利已设定:有限权利: 至少有一组限制访问。